home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.2 for Intel / NeXTSTEP 3.2 for Intel.iso / NextLibrary / Documentation / Sybase / DBLIB / Section2 / dbsetlapp.nr < prev    next >
Encoding:
Text File  |  1993-04-22  |  1.2 KB  |  59 lines
  1. .Na "DBSETLAPP" 
  2. .Aa
  3. .Fu
  4. Set the application name in the LOGINREC structure.
  5. .Ih "LOGINREC, setting the application name in"
  6. .Ih "application name, setting"
  7. .Sy
  8. .Sf "RETCODE DBSETLAPP(loginrec, application)"
  9. .Sp "LOGINREC" "*loginrec"
  10. .Sp "char" "*application"
  11. .Co
  12. .Bl
  13. This macro sets the application
  14. field in the 
  15. LOGINREC
  16. structure.  
  17. For it to have any effect, it must be called before
  18. .I "dbopen()."
  19. .Bl
  20. It is not necessary to call this routine.
  21. By default, the application name
  22. will be a null value, or, in the case of the
  23. Macintosh environment, the low memory global
  24. CurApName.
  25. .Bl
  26. \*S uses the application name in its 
  27. .I sysprocesses
  28. table to help identify your process.  
  29. If you set the
  30. application
  31. name, you will see it if you query the 
  32. .I sysprocesses
  33. table in the
  34. .I master
  35. database.
  36. .Bz
  37. .Pa
  38. .Pi loginrec
  39. A pointer to a LOGINREC structure, which will be passed as
  40. an argument to 
  41. .I "dbopen()."
  42. You can get one by calling
  43. .I "dblogin()."
  44. .Pi application
  45. The application name that will be sent to \*S.
  46. It must be a null-terminated character string.
  47. The maximum length of the string, not including the null terminator,
  48. is 30 characters.
  49. .in -.375i
  50. .Re
  51. .br
  52. SUCCEED or FAIL.
  53. .Sa
  54. dblogin,
  55. dbopen,
  56. DBSETLHOST,
  57. DBSETLPWD,
  58. DBSETLUSER
  59.